home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / cpuset.z / cpuset
Encoding:
Text File  |  2001-04-17  |  7.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ccccppppuuuusssseeeetttt((((4444))))                                                            ccccppppuuuusssseeeetttt((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ccccppppuuuusssseeeetttt, mmmmiiiisssseeeerrrr____ccccppppuuuusssseeeetttt - cpuset configuration files
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      A cpuset is defined by a cpuset configuration file and a name.  The
  13.      cpuset configuration file is used to list the CPUs that are members of
  14.      the cpuset and contains any additional parameters needed to define the
  15.      cpuset.  The file permissions of the configuration file define access to
  16.      the cpuset.  Every time permissions need to be checked, the current
  17.      permissions of the file are used.  It is therefore possible to change
  18.      access to a particular cpuset, without having to tear it down and
  19.      recreate it, simply by changing the access permissions. Read access
  20.      allows a user to retrieve information about a cpuset while execute
  21.      permission allows the user to attach a process to the cpuset.
  22.  
  23.      The name of the cpuset is a three to eight character string.  Queue names
  24.      having one or two characters are reserved for use by IRIX.
  25.  
  26.      For information on how to use cpusets in a Trusted IRIX environment, see
  27.      the _cccc_pppp_uuuu_ssss_eeee_tttt(1) man page.
  28.  
  29. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  30.      The following configuration file describes an exclusive cpuset containing
  31.      4 CPUs:
  32.  
  33.      ####ccccppppuuuusssseeeetttt ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn ffffiiiilllleeee
  34.      EEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE
  35.      MMMMEEEEMMMMOOOORRRRYYYY____LLLLOOOOCCCCAAAALLLL
  36.      MMMMEEEEMMMMOOOORRRRYYYY____EEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE
  37.  
  38.      CCCCPPPPUUUU 11116666
  39.      CCCCPPPPUUUU 11117777
  40.      CCCCPPPPUUUU 11118888
  41.      CCCCPPPPUUUU 11119999
  42.  
  43.  
  44.      This specification will create a cpuset containing 4 CPUs, and will
  45.      restrict those cpus to running threads that have been explicitly assigned
  46.      to the cpuset.  Jobs running on the cpuset will use memory from nodes
  47.      containing the cpus in the cpuset.  Jobs running on other cpusets or on
  48.      the global cpuset will not use memory from these nodes.
  49.  
  50. SSSSUUUUMMMMMMMMAAAARRRRYYYY
  51.      Commands are newline terminated, characters following the comment
  52.      delimiter '#' are ignored, case matters, and tokens are separated by
  53.      whitespace which is ignored.
  54.  
  55.      The valid tokens are:
  56.  
  57.      EEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE
  58.           Defines a cpuset to be restricted.  It can occur anywhere in the
  59.           file.  Anything else on the line is ignored.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccppppuuuusssseeeetttt((((4444))))                                                            ccccppppuuuusssseeeetttt((((4444))))
  71.  
  72.  
  73.  
  74.      MMMMEEEEMMMMOOOORRRRYYYY____LLLLOOOOCCCCAAAALLLL
  75.           Threads assigned to the cpuset will attempt to assign memory only
  76.           from nodes within the cpuset.  Assignment of memory from outside the
  77.           cpuset will occur only if no free memory is available from within
  78.           the cpuset.  No restrictions are made on memory assignment to
  79.           threads running outside the cpuset.
  80.  
  81.      MMMMEEEEMMMMOOOORRRRYYYY____EEEEXXXXCCCCLLLLUUUUSSSSIIIIVVVVEEEE
  82.           Threads not assigned to the cpuset will not use memory from within
  83.           the cpuset unless no memory outside the cpuset is available.
  84.  
  85.           If, at the time a cpuset is created, memory is already assigned to
  86.           threads that are already running, no attempt will be made to
  87.           explicitly move this memory.  If page migration is enabled, the
  88.           pages will be migrated when the system detects that most references
  89.           to the pages are non-local.
  90.  
  91.      MMMMEEEEMMMMOOOORRRRYYYY____KKKKEEEERRRRNNNNEEEELLLL____AAAAVVVVOOOOIIIIDDDD
  92.           The kernel will attempt to avoid allocating memory from nodes
  93.           contained in this cpuset.  If kernel memory requests cannot be
  94.           satisfied from outside this cpuset, this option will be ignored and
  95.           allocations will occur from within the cpuset.
  96.  
  97.           _WWWW_AAAA_RRRR_NNNN_IIII_NNNN_GGGG: It is strongly recommended that this option not be used for
  98.           most cpuset configurations.  A side effect of this option is that
  99.           kernel memory allocations become concentrated on the remaining
  100.           system nodes, which may in turn degrade system performance.  This
  101.           option is effective only for certain workload patterns, and could
  102.           cause severe performance penalties in other situations.  It is
  103.           recommended that this option be used only when indicated by SGI
  104.           support.
  105.  
  106.           Currently this option prevents only the system buffer cache from
  107.           being placed on the specified nodes.  Future IRIX releases may
  108.           expand the scope of this protection to exclude other kernel memory
  109.           allocations from the specified nodes.
  110.  
  111.           This option was introduced in IRIX 6.5.7.
  112.  
  113.      MMMMEEEEMMMMOOOORRRRYYYY____MMMMAAAANNNNDDDDAAAATTTTOOOORRRRYYYY
  114.           The kernel will limit all memory allocations to nodes that are
  115.           contained in this cpuset.  If memory requests cannot be satisfied,
  116.           the allocating process will sleep until memory is available.  The
  117.           process will be killed if no more memory can be allocated.  See
  118.           policies below.
  119.  
  120.      PPPPOOOOLLLLIIIICCCCYYYY____PPPPAAAAGGGGEEEE
  121.           Requires MEMORY_MANDATORY.  This is the default policy if no policy
  122.           is specified.  This policy will cause the kernel to page user pages
  123.           to the swap file (see _ssss_wwww_aaaa_pppp(1M)) to free physical memory on the nodes
  124.           contained in this cpuset.  If swap space is exhausted, the process
  125.           will be killed.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccppppuuuusssseeeetttt((((4444))))                                                            ccccppppuuuusssseeeetttt((((4444))))
  137.  
  138.  
  139.  
  140.      PPPPOOOOLLLLIIIICCCCYYYY____KKKKIIIILLLLLLLL
  141.           Requires MEMORY_MANDATORY.  The kernel will attempt to free as much
  142.           space as possible from kernel heaps, but will not page user pages to
  143.           the swap file.  If all physical memory on the nodes contained in
  144.           this cpuset are exhausted, the process will be killed.
  145.  
  146.      CCCCPPPPUUUU cpuid
  147.           Specifies a CPU that will be part of the cpuset.
  148.  
  149. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  150.      cpuset(1), cpuset(5).
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.